home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / gfx / misc / phoon.lha / readme.amiga < prev    next >
Text File  |  1992-09-20  |  3KB  |  94 lines
  1.  
  2. phoon - program to show the current phase of the moon on the
  3.     Amiga display. ported from the X11 program xphoon.
  4.  
  5.     I ported this program so I can enjoy the same background picture as I have
  6.     On the Xterminals I use. I release this so you all can also enjoy it.
  7.  
  8.     My part of the program is entirely free. Read other copyright notices from
  9.     libs and original directories.
  10.  
  11.     and DISCLAIMER: use this program at your own risk. This software is 
  12.     provided "as is" without express or implied warranty.
  13.  
  14.  
  15.     to run this program you need ixemul.library and iff.library located
  16.     in your libs:directory and one of the fullmoon pictures (from fullmoons
  17.     directory in this distribution, names tell the x and y -radiuses of the
  18.     fullmoon pictures).  Default path for fullmoon picture is "fullmoon.ilbm"
  19.     on current working directory, but that can be changed by binarypatching
  20.     the "phoon" or by giving a new path at command line.
  21.  
  22.     Program outputs the phoon picture to ram:phoon.pic -file.
  23.  
  24.     Usage for this program is:
  25.  
  26.     phoon [-s] [-d] [-f filename] [-g dcx[dcy[drx[dry]]]] [-r]
  27.  
  28.  
  29.     -s :shades the shadowed part of the moon w/ calculated approximate
  30.         earthlighting, without this flag the area becomes completely
  31.         black.
  32.  
  33.     -d :this flag douples every bit in shading pattern. If one's monitor
  34.         can't show single bits well, I have included fullmoon pictures
  35.         whose bits are doubled too (d504x252.ilbm and d504x189.ilbm)
  36.  
  37.     -f filename :path and filename of the fullmoon picture you want to use
  38.         default filename is "fullmoon.ilbm" and it can also be 
  39.         binarypatched to any name, max approximately 50 chars long. 
  40.  
  41.     -g dcx[dcy[drx[dry]]] :there are fullmoon pictures of different sizes.
  42.          this program gets the center and radius of the picture depending
  43.          on the size ratios between original (1600x1280) and the used
  44.          fullmoon picture. the ratio between bigfullmoon and fullmoon 
  45.              radius and center is not always same (or there is a bug in 
  46.          calculations). This option changes the center and radius of the
  47.          moon picture. For example -g +1-5+6 moves center one left and 5 
  48.              up, increasing x-radius by 6.
  49.          Now i have noticed, that all fullmoons get shadowed correctly,
  50.          but there might be need for this option anyway (at least it is
  51.          fun to play w/ it)
  52.  
  53.     -r :this option reverses black and white color. this is for 1.3 users
  54.        ( I don't know if this works on 1.3)
  55.  
  56.  
  57.     How to put fullmoon picture on the workbench background:
  58.  
  59.     add NickPrefs to your s:startup-sequence just after IPrefs (read
  60.     NickPrefs documentation about it)
  61.  
  62.     copy envars_sys/phoon_wbpic.prefs to your envarc:sys directory
  63.  
  64.     write these lines in start of your s:user-startup:
  65.  
  66.        SetEnv TZ (your time-zone)
  67.        Assign etc: ram:
  68.        Stack 10000
  69.        phoon (options you might need)
  70.        Stack 4096
  71.        Rename env:sys/phoon_wbpic.prefs env:sys/wbpicture.prefs
  72.  
  73.     and to end of your s:user-startup
  74.  
  75.     Delete ram:phoon.ilbm
  76.  
  77.         For 1.3 I remember there is a program which puts any iff-picture to the
  78.          workbench background.
  79.  
  80.     fullmoon pictures are made the following way: (in unix w/ pbmplus)
  81.  
  82.     xbmtopbm bigfullmoon.xbm | pnmscale .6666 | pgmtopbm | pbmtoilbm >504x504.ilbm
  83.     xbmtopbm bigfullmoon.xbm | pnmscale -xscale .3333 -yscale .25 | pgmtopbm | p4doublepixel | pbmtoilbm >d504x189.ilbm
  84.     ...
  85.  
  86.     Have fun
  87.  
  88. Tomi Ollila
  89. too@cs.hut.fi
  90. Kitarakuja 1 A 266
  91. 00420 Helsinki
  92. Finland
  93. -358-0-563-5733
  94.